Retrieve paginated list of applications

Required Permission: mad.application.management.list

Retrieves a paginated and filterable list of all mobile and desktop applications within the specified organization, allowing administrators to browse, search, and manage their application portfolio across multiple platforms and deployment environments.

GET

https://api.applivery.io/v1/organizations/{organizationId}/apps

curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/apps" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/apps", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/apps",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Unique identifier or URL-friendly slug for the organization that owns the applications to operate on, establishing organizational scope for all nested application operations.

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

page integer

optional

Page number for result pagination starting from one, enabling navigation through large datasets by dividing results into manageable chunks.

limit integer

optional

Maximum number of items to return per page, controlling response size and enabling efficient data loading with configurable batch sizes.

sort string

optional

Ordering criteria using field:direction format to organize results based on specific attributes, supporting ascending or descending sort order.

Match pattern: ^[\w.]*((:asc)|(:desc))?$

name string

optional

Filter applications by exact or partial match on application name for finding specific apps in the organization.

≤ 128 characters

slug string

optional

Filter applications by exact or partial match on URL-friendly slug identifier.

≤ 128 characters

appToken string

optional

Filter applications by their unique application token used in SDK integrations and API authentication.

≤ 128 characters

oss string

optional

Filter applications by operating system platform support including ios, android, macos, or windows.

iosandroidaospmacoswindowspackage

platform string

optional

Filter applications by specific build platform or architecture variant for granular compatibility filtering.

≤ 256 characters

search string

optional

General search term to match against application name, slug, or other searchable fields for fuzzy finding.

≤ 256 characters

metadata object

optional

Filter applications by custom metadata key-value pairs matching specific organizational attributes or tags.

lean boolean

optional

Return minimal application data excluding heavy nested objects and statistics for faster response times when full details are not needed.

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

id string optional

Unique identifier for the application within the platform, used to reference this specific mobile or desktop app throughout the entire distribution workflow and analytics tracking.

Match pattern: ^[a-fA-F0-9]{24}$

name string optional

Human-readable name of the application that is displayed across the dashboard, distribution portals, and device management interfaces to help users identify the app being managed.

≤ 128 characters

slug string optional

URL-friendly unique identifier derived from the application name, used for public-facing store pages, download links, and shareable distribution URLs that end users will interact with.

≤ 128 characters · ≥ 3 characters · Match pattern: ^[a-z0-9][a-z0-9-]+[a-z0-9]$

sdk object optional

Platform-specific SDK configuration that governs how the mobile application interacts with the distribution platform, including update mechanisms, authentication, and version control for both iOS and Android.

notifications object optional

Notification preferences that control automated communication workflows for new builds, updates, and user feedback, enabling organizations to keep stakeholders informed throughout the application lifecycle management process.

description string optional

Detailed textual description of the application providing context about its purpose, target audience, key features, and business use case to help team members understand its role.

≤ 1000 characters

oss array [string] optional

Array of operating system platforms that this application supports or has builds available for, including iOS, Android, macOS, and Windows, enabling cross-platform distribution and device management capabilities.

buildPlatforms array [string] optional

List of specific build platforms and architectures that have been uploaded for this application, providing granular detail about device compatibility such as iOS universal, Android ARM64, or Windows x86.

security object optional

Security context object containing the current user's authorization level and permissions for this application, used to enforce role-based access control throughout the dashboard and API endpoints.

configuration object optional

Advanced configuration settings that control storage, security, retention policies, and integration parameters for this application, allowing administrators to customize behavior according to organizational policies and compliance requirements.

retentionApplied object optional

lastBuildProcessedDate string optional

Timestamp indicating when the most recent application build was successfully uploaded, processed, and made available for distribution, useful for tracking deployment cadence and identifying stale or inactive applications.

Format: date-time

picture string optional

URL or path to the application's icon image displayed in distribution portals, device management interfaces, and user-facing download pages to provide visual identification and branding consistency.

pictureSource string optional

Indicates the origin of the application icon image, whether manually uploaded by administrators, automatically extracted from uploaded build packages, or sourced from app store metadata synchronization processes.

manual last build

organization string optional

Unique identifier for the organization or tenant that owns and manages this application, establishing the organizational boundary for access control, billing, and resource isolation in multi-tenant environments.

Match pattern: ^[a-fA-F0-9]{24}$

counts object optional

Statistical metrics and aggregated counts related to this application, such as total number of builds, active installations, feedback submissions, or distribution downloads, providing operational insights and usage analytics.

metadata object optional

Flexible key-value object for storing custom application attributes, integration identifiers, or business-specific data that extends the core application model without requiring schema modifications for unique organizational requirements.

defaultScripts object optional

Predefined automation scripts that execute at specific lifecycle events for all builds of this application, such as post-upload processing, notification triggers, or integration webhooks that streamline deployment workflows.

createdBy string optional

Identifier and metadata about the user or system account that originally created this application record, providing audit trail information for compliance, security reviews, and organizational accountability tracking.

Match pattern: ^[a-fA-F0-9]{24}$

createdAt string optional

Timestamp indicating when this application was first registered in the platform, establishing the baseline for lifecycle tracking, billing calculations, and historical reporting of application management activities.

Format: date-time

updatedAt string optional

Timestamp indicating when this application record was last modified, including changes to configuration, metadata, or any other application properties, essential for change tracking and audit compliance requirements.

Format: date-time

totalDocs integer optional

limit integer optional

hasPrevPage boolean optional

hasNextPage boolean optional

page integer optional

totalPages integer optional

prevPage integer optional

nextPage integer optional

lean boolean optional

{
    "status": true,
    "data": {
        "items": [
            {
                "id": "507f1f77bcf86cd799439011",
                "name": "Enterprise Mobile Banking App",
                "slug": "mobile-banking-app",
                "sdk": {
                    "ios": {
                        "ota": true,
                        "forceUpdate": false,
                        "minVersion": "2.5.0",
                        "forceAuth": true,
                        "detected": {
                            "sdkVersion": "3.2.1",
                            "capabilities": [
                                "ota",
                                "auth",
                                "feedback"
                            ],
                            "integrationValid": true
                        },
                        "lastBuildId": "507f1f77bcf86cd799439014",
                        "lastBuildVersion": "3.1.2"
                    },
                    "android": {
                        "ota": true,
                        "forceUpdate": false,
                        "minVersion": "2.5.0",
                        "forceAuth": true,
                        "detected": {
                            "sdkVersion": "3.2.1",
                            "capabilities": [
                                "ota",
                                "auth",
                                "feedback"
                            ],
                            "integrationValid": true
                        },
                        "lastBuildId": "507f1f77bcf86cd799439014",
                        "lastBuildVersion": "3.1.2"
                    }
                },
                "notifications": {
                    "newBuildNotifyCollaborators": true,
                    "newBuildNotifyEmployees": false,
                    "newBuildMessage": "This release includes critical security patches and new features for enhanced mobile banking. Please update immediately to ensure continued access to your accounts.",
                    "newFeedbackNotifyCollaborators": true
                },
                "description": "A secure mobile banking application designed for enterprise customers, featuring biometric authentication, real-time transaction monitoring, and seamless integration with our core banking systems.",
                "oss": [
                    "ios",
                    "android"
                ],
                "buildPlatforms": [
                    "ios",
                    "android"
                ],
                "security": {
                    "role": "org.admin"
                },
                "configuration": {
                    "storageProvider": {
                        "id": "507f1f77bcf86cd799439012",
                        "name": "AWS S3 Production Bucket",
                        "region": "eu-west-1",
                        "config": "production-app-storage",
                        "provider": "aws-s3"
                    },
                    "emmJwtSignature": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkVudGVycHJpc2UgQXBwIn0.signature",
                    "notificationLanguage": "en",
                    "buildRetentionDays": 90,
                    "buildsRetainedPerPublication": 5
                },
                "retentionApplied": {
                    "maxBillingBuildRetentionDays": 0,
                    "buildsRetainedPerPublication": 0
                },
                "lastBuildProcessedDate": "2026-02-03T10: 30: 00.000Z",
                "picture": "https://cdn.applivery.com/apps/507f1f77bcf86cd799439011/icon.png",
                "pictureSource": "build",
                "organization": "507f1f77bcf86cd799439013",
                "counts": {
                    "totalBuilds": 127,
                    "activeInstalls": 3421,
                    "feedbackCount": 45
                },
                "metadata": {
                    "costCenter": "IT-2024",
                    "projectCode": "MOBILE-BANK-001",
                    "complianceLevel": "PCI-DSS"
                },
                "defaultScripts": {
                    "preInstall": "string",
                    "postInstall": "string",
                    "audit": "string",
                    "enforce": "string",
                    "runner": "string"
                },
                "createdBy": "507f1f77bcf86cd799439016",
                "createdAt": "2025-01-15T09: 00: 00.000Z",
                "updatedAt": "2026-02-03T14: 25: 00.000Z"
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0,
        "lean": true
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}

Request

Authorization

Path Params1

Query Params11

Responses